Node / ReticulumProjects / MeshChatX.git / files / docs / en / interfaces.md

Displaying Raw • View rendered • Download

Tc9d1d9# Reticulum interfaces

Interfaces connect your MeshChatX node to the Reticulum mesh. Manage them from the **Interfaces** page.

Tc9d1d9## What an interface does

Each interface is a Reticulum transport definition. Examples include TCP over the internet, UDP discovery, LoRa through an RNode, serial KISS devices, I2P tunnels, and automatic LAN discovery.

MeshChatX reads and writes interface configuration in your Reticulum config directory (default Ta5d6ff`~/.reticulum`).

Tc9d1d9## Supported interface types

The **Add interface** flow includes:

| Type | Typical use |

| --------------------- | --------------------------------------------- |

| TCPClientInterface | Connect outbound to a known TCP peer |

| TCPServerInterface | Accept inbound TCP connections |

| BackboneInterface | High-throughput backbone link |

| UDPInterface | UDP transport with discovery helpers |

| RNodeInterface | LoRa via RNode (serial, BLE, or IP transport) |

| RNodeIPInterface | RNode reached over IP |

| SerialInterface | Direct serial devices |

| KISSInterface | KISS TNC devices |

| I2PInterface | I2P-based Reticulum transport |

| AutoInterface | Automatic discovery on local networks |

| HTTPInterface | HTTP/S tunnel (bundled RNS-over-HTTP) |

| Custom external types | Advanced setups |

Community-curated suggestions come from Ta5d6ff`community_interfaces.json`, sourced from [Tff7b72directory.rns.recipes](Te6edf3https://directory.rns.recipes).

Tc9d1d9## Interface discovery

Discovery can automatically connect to peers on your LAN or configured networks. You can maintain allowlists and blocklists, set autoconnect behaviour, and assign a network identity for discovered peers.

Tc9d1d9## Import and export

Export your interface set for backup or clone it to another machine. Import validates entries before applying them.

Tc9d1d9## RNode tools

LoRa setups often need firmware management. **Tools → RNode Flasher** opens the bundled flasher at Ta5d6ff`/rnode-flasher/`. Configure frequency, bandwidth, spreading factor, and TX power when adding an RNode interface.

Tc9d1d9## Websocket server interface

MeshChatX includes a custom Ta5d6ff`WebsocketServerInterface` for WebSocket-based Reticulum transport. Use it when bridging to web-friendly gateways.

Tc9d1d9## HTTP tunnel interface

MeshChatX vendors [Tff7b72RNS-over-HTTP](Te6edf3https://github.com/Quad4-Software/RNS-over-HTTP) and installs Ta5d6ff`HTTPInterface.py` into your Reticulum Ta5d6ff`interfacepath` on startup. Use **Add interface → HTTP Tunnel** for client or server mode when only HTTP/S egress is available. Default transport is HTTP/1.1. HTTP/2 and HTTP/3 need TLS and optional extra packages on the server side.

Tc9d1d9## Getting onto the mesh

A minimal path for a new node:

Ta5d6ff```

Install MeshChatX

|

v

Add interface (TCP client, community suggestion, or RNode)

|

v

Reticulum establishes transport

|

v

Paths and announces populate in the UI

|

v

LXMF, LXST, and Nomad features become reachable

```

Tff7b721. Pick a community interface or ask your mesh operator for TCP endpoint details.

Tff7b722. Add the interface and enable it.

Tff7b723. Watch the path table (**Tools → RNPath**) if connectivity fails.

Tff7b724. Enable **auto-announce** so your services are visible.

Tc9d1d9## Bundled documentation hints

The Interfaces UI links into the Reticulum manual sections on interface options. Open **Documentation → Reticulum** and search for Ta5d6ff`interfaces` if you need field-by-field reference.

Tc9d1d9## Tips

Tff7b72- Run only the interfaces you need. Each open port or radio adds attack surface and power draw.

Tff7b72- On Raspberry Pi and Android, prefer a single well-known TCP uplink if LoRa hardware is not attached.

Tff7b72- After editing Reticulum config externally, use the reload controls or restart MeshChatX so changes apply cleanly.

Tff7b72- Keep firmware on RNodes current using the flasher tool before debugging RF issues.

Tc9d1d9## See also

Tff7b72- **Installation and setup** for Reticulum config directory flags

Tff7b72- **Tools and utilities** for RNPath, RNProbe, and Ping

Tff7b72- Reticulum manual **Interfaces** chapter for protocol-level detail